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QPIP - OS/8 DIRECTORY EDITING PROGRAM 


DECUS Program Library Write-up 


DEC US NO. 8-649 


This programme provides a few file management facilities not 
available with OS/8 PIP. These are: 


1. Deleting files undeletable by PIP. 


2. Reserving space on a directory device. 

3. Changing names of files without having to transfer their contents. 

4. Handling inquiries for device information. 

To do this the programme incorporates its own command decoder, 
with syntax identical to the usual one, but allowing any characters except 
in device names, file names and extensions. 









QP1P Write Up 


Objective: 

Having used OS/8 for a year, it became obvious that several 
file management facilities were occasionally desirable, but were not 
conveniently available. The programme SP1P by D.M. Kristol included on 
the dectape of DECUS8 - 497 fills many of these gaps, and this is an 
attempt to fill a few more. The following is a list of some of the 
problems solved by QP1P. 

1. Fortran, Basic and machine code programmes, and the Basic 
editor, if used carelessly can produce files whose names contain non- 
alphanumeric characters. These files can be neither moved nor deleted 
with PIP, and cannot be accessed by other conventional system programmes. 

2. It very often happens that a wanted file is deleted, perhaps 
by creating a new file with the same name, and in such cases one can often 
see the empty space left by the deleted file in a directory listing. 

Normally all that is required to recover the file is to put a name to this 
space. 

3. Many programmes create files with temporary names - e.g. 

BASIC.WS, PAL8BN.TM, etc. which a user may decide later are worth preserving 
the only way to do this previously was to copy the file to a new name with 
PIP. This is no trouble on an empty disk, but can be very tedious with 
full dectapes. 

4. When sorting files on a mass storage device (e.g. for maximum 
overlaying speed) it is easier to rearrange them if space can be reserved 
to put files in later. 

5. An inquiry for device information can clarify puzzling situations. 
Two of our users spent a very worried morning blaming hardware faults having 
inadvertantly assigned "DTA0" to dectape unit 1 and "DTAl" to dectape unit 0. 
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Programme Description 


To satisfy the requirement of accessing files whose names contain 
non-alphanumeric characters, the programme contains its own command decoder. 
This is completely compatible with the normal OS/8 command decoder on valid 
input, and produces a similar table from the file specifications and options. 
Its use should cause no problems to an experienced OS/8 user, but since it may 
be extracted for use in other programmes it is described more fully. It 
consists of two independant subroutines, a line input subroutine and a line 
analysis subroutine. 

The line input subroutine inputs characters from the keyboard 
and places them unpacked in a buffer. A zero word marks the end of text in 
this buffer. The subroutine returns with a pointer to the first character of 
the buffer in the AC. All the normal editing facilities are available. The 
subroutine exits on either alt-mode, carriage return, or buffer overflow 
(72 characters). Carriage return or alt-mode are not put into the buffer, 
but a page 0 flag is set. The buffer size may be changed by altering the 
parameter in the Z BLOCK pseudo op. just after the label B0. There are minor 
differences in response as compared to the normal command decoder. 

1. A new is printed after cont./U. or line feed. 

2. Illegal non printing characters are completely ignored and do 

not echo. 

3. If one is between rubout back slashes and cont./U. or cont./C. 

is typed the rubout brackets are closed before the +U or +C echo. 

The line analysis subroutine is entered with a pointer to the 
start of the line in the AC, If it is successful it packs the analysed line 
in a standard format into the buffer at B1 and returns with a skip. Otherwise 
it prints an error message and does not skip. The buffer at B1 is divided into 
two parts, one for input files and the other for output files. The numbers 
of each of these are currently set to 3 of each, but may be changed in the 
source by altering the Z BLOCK arguments. The line analysis routine does not 
look up input file names, the square bracket option can be used on both input 
and output file names and can specify a number up to 4095. Consequently all 
file specifications occupy 6 words as follows:- 
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1. Device number (0 if no device specified). 

2. Square brackets option (0 if not used). 

3 to 6 Packed 6 bit file name and extension in the usual format. 

All normal command decoder options are handled, with some 
extensions as follows:- 

1. Since the "= fl option is not packed with the alt-mode switch, 
numbers to 7777 7777 are permitted. 

2. The square brackets option may be used with input as well as 
output files, may specify up to 4095, and may be embedded 
within device name, file name or extension. 

3. Except for the following characters, all printing characters 
including space may be used in device names, file names and 

. _ •_ rpi _ It II II II ll^ll II. II If. II 11/7=) 11 If_II II /II 

extensions. The exceptions are . , < +■ : (9 = / 

ii ^ ii ii j-ii 

All of these characters except may be used by protecting 
between two f, @" characters. The first character disables 
checking of special characters while the second re-enables it. 

Apart from this f, @" characters are ignored. 

All characters are packed correctly, unlike the packing of 
by the normal command decoder in special mode. 

4. Some forms of invalid syntax accepted by the normal command 
decoder are rejected by this one. 

The main programme calls the two subroutines comprising the 
command decoder to obtain a specification of its operation. The option 
switches R, I, C are checked in turn, and the first one found set is acted upon 
The others are ignored. Afterwards the P option is checked. 

The R option uses the USR to look up an input file and having 
found it, USR pointers are used to modify the directory segment in core 
and rewrite it. Each input file is looked up in turn. 

The I option reads from device tables in the USR and the 
top of field 1 the information about each input device and puts this in 
a readable ASCII form to the first output file. 
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The C option takes each output file in turn. If the specified 
size (square brackets option) is non zero a file of that name is opened 
using the USR. The USR is then called to close the file with the specified 
size even if this was zero. 

The P option uses the USR to chain to P1P.SV on the system device. 

Loading and Saving Instructions 

Assuming that the paper tape of the PAL8 source file has been 
transferred to DSK:QP1P.PA, the following sequence of instructions will 
produce a working version: 

.R PAL8 

*QP1P < QP1P 

.R ABSLDR 

*QP1P/9S$ (alt-mode typed) 

.SA SYSrQPIP 

The programme may then be run with the instruction: 

.R QP1P 
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I i\i.3 i ,< UC 1 I J N S F0< uPIP 


I Ht PSJGSAMME I j A j£N£,\AL J i/6 UlixECIOKY MODIr YIN3 i J S ) 3 S A ■I M E 

F AC I L I r I EG ASE 1 ) SENAM IMG FILES 

20CKEA TING FILES OF SPECIFIED NAME AND SI ZE 
J)DELE I ING FILES 

4 > PS IN1 I Nr'OsMA 1 I ON F :S OM SYSTEM DEVICE TABLES 

wHEi\ 1 HE PrOGsAMME IS SJN IT PHI NTS AN " , AND ACCEPTS A LINE 

OF COMMANDS IN A SIMILAR MANNEH TO 1HE NOHMAL COMMAND DECODES. 
HOwEVEH A MJCH wlDES HAN3E OF CHAHACTErti IS AVAILABLE. 

ALL PH IN TING CHAHACTErti INCLUDING ” ”,001 EXCLUDING "•*" 

MAY HE USED IN DEVICE NAMES*FIL£ NAMES AND EXTENSIONS. 

MOST CHASACIESS MAY HE USED DIH£CiLY*BUT THOSE HAVING SPECIAL 
MEANING TO THE COMMAND DECODES f E.G. "<"> MOST HE PSOTECTEu 
BY A PAIS OF "#'* C HAS AC 1 ESS. 

A PAS 1 FSOM THIS THE COMMAND LINE Ii CONS I HOC!ED AS USUAL. 

S INPUT* AND J OUTPUT FILES ASE PESMI11ED. 

THE PSOGSAMME USES OPTIONS "C'SVS’TS'V". 

THESE ASE NO DEFAULT EXTENSIONS. 

THE "C" OPTION CHEATES FILES AS SPECIFIED IN THE OUTPOl 
r ILE LIST * DELETING OLD FILES OF' THE SAME NAMES. 

IF THE FILE i I EE IS /) THEN A N£w FILE IS NOT CHEATED. 

THIS MAY BE USED TO DELETE FILES JNDELETABLE WITH PIP BECAUSE 
OF THEIS NAMES OS TO SECOVES FILES ACCIDENTALLY DELETED. 
DEFAULT DEVICE Ii DSK. 

iHE ”H" OPTION SENAMES FILES IN THE DISECIOSY. 

EACH INPUT FILE HAS ITS NAME CHANGED 10 THE COSSESPONDING 
00 IPJ T FILE NAME. THIS MAY HE UiED wHEN A PnOGSAMME 
INCOSSECTLY PSOOUCEG MULTIPLE FILEi OF THE SAME NAME* Os 
FILES WITH NAMES CONTAINING INVALID CHArcAClESS* OS EVEN 
TO MAKE SOME FILES ON A SYS)EM UNAVAILABLE 10 AN OSD T NAS Y 
USES. DEFAJL1 INPUT DEVICE IS DSK. 

DEFAULT OUTPUT DEVICE IS SAME AS COsSEiPONDING INPUT DEVICE 
AND THE COMMAND IG INVALID IF IHE DEVICES ASE DTFFESENT. 

THE "I" OPTION LOOKS UP DEVICE KNFOSMAII ON [N THE SYSTEM 
1AHLES FOS EACH INPUT DEVICE* AND OUTPUTS A SUMMASY TO 
THE FIHST OUIPUT FILE. 01HES OUTPUT FILES ASE I3N0SED. 

THE DEFAULT OUTPUT DEVICE IS DSK AND THESE ASE NO DEFAULT 
INPUT DEVICES. 


T He. "P" OP I I ON CHAINS TO PIP ON COMPLETION. 
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.R P IP 
*DTA2:/E 

9/3/73 

<EMPTY> 730 
730 FREE BLOCKS 

*t C 

.R QP IP 

*DTA2:TEM1 .XXtl 73,DTA2:TEM2.YYC300 3 </C 
*/P 

♦DTA2J/E 


9/3/73 

TEM1 .XX 17 9/3/73 
TEK2 .YY 300 9/3/73 
<EKPTY> 413 
413 FREE BLOCKS 


*t C 


N/ 


.R QP IP 
*TEM3tU 

*DTA2 :TEM3•ZZ[ 1 3,DTA2:TEM4.&&t33</C/P 
*DTA2: /E 


"A 


9/3/73 

TEM1 .XX 17 9/3/73 
TEM2 *YY 300 9/3/73 
TEM3 .Z Z 1 9/3/73 

TEM4 •&& 3 9/3/73 

<EMPTY> 409 
409 FREE BLOCKS 

*TEM2•YY</01U 
DTA2:TEM2.YY</D 
*DTA2:/E 

9/3/73 

TEM1 .XX 17 9/3/73 
<EMPTY> 300 
TEM3 .ZZ 1 9/3/73 

TEM4 .&& 3 9/3/73 

<EMPTY> 409 
709 FREE BLOCKS 

*t c 




OS>£ 

w irH A ccGjqfi/ 

l>ecta Re¬ 


start gipiP 

CREATE 2 Piles as 
ChA/V to pip 

PlP t— I S i S < H E A/E tu' ^ IA y 

Note that si2.es 6/Reate e 

THAN 2§6 &COCfcS fA Ay Se' 

£ fee. Ip/E£> 


_ y. . j / Ar% 2 ✓ f nAsr/u 

IU ■* i K.u-t. / i w /*>'■'*■ • > • 

CREATE ZNIoRE PICE'S ANV CHAIN TV 
PlP ON com 0 C&rioAs 

Note That non au>nanomer/c 
CHARA CtERS ARE PERMITTED 


ORDlNdfiy OSE Opr pip 


J 
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• R QPIP $*TEM2•\.2MET\DTA2:TEM2.B6C 3003 </C 

*TEM4.t(J 

*DTA2:TEK4.AA<DTA2:TEM4.&&(RP ) 

*DTA2:/E 


CREATE ! F U.E C* or eAuteur) 
C' OMMAVO A&oftTGO ' 

CHfiVOcE- A A//1M £ Am T*ev CHHI/UTO 


9/3/73 

TEN1 .XX 17 9/3/73 
<EMPTY> 330 
TEK3 .ZZ 1 9/3/73 

TEM4 .AA 3 9/3/73 
TEK2 .38 330 9/3/73 
<EMPTY> 109 
409 FREE SLOCKS 

*TEM4.AA</D 
ERROR DELETING FILE 
*DTA2:TEM4.AA</D 
*t C 


~ 2SS 
w*™* U& i?s>& 


J 0 l. , ) ~~ TEVAt.Bs 
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• R QP IP 

*TEM5• t ij . _ 

*DTA2 :TEM5.AAC33 * TEM1 . \. 1 M.ETYDTA2 S TEM1 . XX</C /P CREATE I FiC.E AvC> 

DELETE A/OOTHER - C AA/AJ TO P• A 


*DTA2:/E 

9/3/73 


<EMPTY> 

31 7 


TEM3 

• ZZ 

1 

9/3/73 

TEM5 

• AA 

3 

9/3/73 

TF.M2 

• B8 

300 

9/3/73 

<EMPTY> 

109 


426 

FREE 

BLOCKS 


J 


£lf 5 fiL. 

V^rre^l } 1~ETAS.AA 

'Tffy cCas. £K~STEh4.AA 

J* iy 


*t c 
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.R QP IP 


«u &ouT 


*DTA2:@..<?@.A@(@<TEM3•\•3MET\DTA2:TEM3«ZZ/R 
♦TTY;<DTA2:^DSKs/I 

QP IP DEVICE- ENQUIRY BDM JUL.73 

DEVICE INFORMATION CURRENTLY IN SYSTEM TABLES 

DEVICE NO. 1 
SYSTEM DEVICE NO. 0012 
HANDLER SAVED ON BLOCK 0017 
ENTRY AT 0012 
DEVICE CONTROL WORD 4160 

DEVICE NO. 2 
SYSTEM DEVICE NO. 0002 
PERMANENTLY RESIDENT HANDLER 
ENTRY AT 7607 
DEVICE CONTROL WORD 4060 



Vo re 0 fr <£/ ^ PB&Tecr- 

SPecnqc. C. H/)AAcr&#s 

xvasiee’ As^ur t>T«z 

AAJP 1>Sk'. 

swce Vo Ass^vMBMt 

*** ,v ««v.r {lWt 

Jv$i /)$ <£> PSCTEJS 


*(P ) 

+DTA2 S/E 
9/3/73 


<EMPTY> 

317 


..<? .A ( 

1 

9/3/73 

TEM5 .AA 

3 

9/3/73 

TEM2 .BB 

300 

9/3/73 

<EMPTY> 

109 


426 FREE 

BLOCKS 


*DTA2:</Z 
*f C 


OHAIV TO PlP 

T Ml* SHOWS Tfjj c- ^ 

^ « fS ^rs O A" Tfrl£ 

Here rnAT w 

fA°<kli*»lnr c»v Access 

f/ier t Tn°o WH ,r is srw Me „ei. 

/a; A s a •/( s h 


9 















